home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / tag_bbs / newmsgc.zip / NEWMSG.DOC < prev    next >
Text File  |  1992-06-10  |  10KB  |  237 lines
  1.                                  NEWMSG 1.01
  2.             T.A.G. 2.6c1 Hudson Style Msgbase New Message Scanner
  3.                                    6/10/92
  4.                                by Mark McKay
  5.  
  6.                                  Disclaimer
  7.                                  ~~~~~~~~~~
  8.   This program is guaranteed to take up some of your precious disk space.
  9.   The author Mark McKay is in no way liable for what occurs because you
  10.   feel to need to run it.  The person operating the program is totally
  11.   responsible for all consequences of running this program.  You break it
  12.   you own it!
  13.  
  14.                                     NOTES!!
  15.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  16.                      UPGRADING FROM PREVIOUS VERSIONS
  17.                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18.    1.  Depending upon which previous version you ran, you'll need to
  19.        rename QCHKNEW.CFG or TNEWMSG.CFG to NEWMSG.CFG.  The format should
  20.        be the same.
  21.  
  22.    2.  Prior to running NEWMSG.EXE you *MUST* run MKAF.EXE first to make
  23.        the area file NEWMSG uses now instead of MBOARDS.DAT.  To do so,
  24.        when you run MKAF just put the directory on the commandline.
  25.        ex.  MKAF C:\BBS\DFILES\    <- would look for MBoards.dat in your
  26.        C:\BBS\DFILES directory.  The backslash is optional.
  27.  
  28.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  29.    OTHER NOTE - Due to a Hard drive crash the source code to all the previous
  30.                 versions of TNEWMSG (and loads of other things) in Hard drive
  31.                 heaven (one of these days I'll learn to back things up more
  32.                 than every 6 months or so).
  33.  
  34.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35.  
  36.                                    Files
  37.                                    ~~~~~
  38.   NEWMSG.EXE   - The TAG 2.6 Hudson/Fido new message scanner.
  39.   NEWMSG.DOC   - You are reading it.
  40.   MKAF.EXE     - Makes smaller MBOARDS.DAT type file, NEWMSG.DAT
  41.   MKHIDX.EXE   - Makes TMSGIDX.BBS in each Hudson message directory.
  42.   NEWMSG.CFG  - Sample configuration file. (Edit to suit your system)
  43.   NEWMSG.BAT   - Sample batch file to run the door.
  44.  
  45.                                    Features
  46.                                    ~~~~~~~~
  47.   -  Scans for just Hudson Style messages.  Fido support will be added at a
  48.      later date.
  49.  
  50.   -  Scans for both the users Real Name and Handle.
  51.  
  52.   -  Tells user TAG Message area, TAG Message number, the person the message
  53.      is from and the subject of the message for all messages to the user.
  54.  
  55.   -  Now allows searching for a subject in msgs. (for those with access levels
  56.      >200)
  57.  
  58.   -  Now allows searching for messages to other people. (for those with access
  59.      levels >200)
  60.  
  61.                                   Requirements
  62.                                   ~~~~~~~~~~~~
  63.   1.  Before you do anything you must make the configuration file, NEWMSG.CFG.
  64.  
  65.       Example NEWMSG.CFG files
  66.  
  67.       Note: There must ALWAYS be at least 4 lines in NEWMSG.CFG.
  68.  
  69.       Structure of NEWMSG.CFG for 2 Hudson style message areas:
  70.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  71.       Line 1 : c:\tag\                  <-- your Main BBS Directory
  72.       Line 2 : c:\tag\gfiles\           <-- path to USER.LST
  73.       Line 3 : c:\tag\gfiles\           <-- path to MBOARDS.DAT
  74.       Line 4 : 2                        <-- # of Hudson style MSG bases
  75.       Line 5 : C:\TAG\QBBS\             <-- Hudson msg base 1 directory
  76.       Line 6 : C:\RA\                   <-- Hudson msg base 2 directory
  77.  
  78.       Structure of TNEWMSG.CFG for 1 Hudson style message area:
  79.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  80.       Line 1 : c:\tag\                  <-- your Main BBS Directory
  81.       Line 2 : c:\tag\gfiles\           <-- path to USER.LST
  82.       Line 3 : c:\tag\gfiles\           <-- path to MBOARDS.DAT
  83.       Line 4 : 1                        <-- # of Hudson style MSG bases
  84.       Line 5 : C:\TAG\QBBS\             <-- Hudson msg base 1 directory
  85.  
  86.       NOTE: If you mess up this setup the door will crash guaranteed! :)
  87.  
  88.       If you have more than 1 Hudson style message area then Line 4 must be
  89.       the number of Hudson style areas you have.  Lines following Line 4
  90.       must be the path(s) to the Hudson areas.
  91.  
  92.   2.  Before running Newmsg you must run MKHIDX if you have any Hudson
  93.       style message areas.
  94.  
  95.   3.  Edit your Binkley/Mailer.Bat to run MKHIDX "EVERY" your BBS exits or
  96.       in your logoff.bat if you don't run a mailer.
  97.       The data files these programs make will only be updated
  98.       if there are changes in the size of the Hudson style message base(s).
  99.       
  100.                                    Quick setup
  101.                                    ~~~~~~~~~~~
  102.     1.  Put the files in a directory.
  103.     2.  Edit NEWMSG.CFG  <- if it's wrong the program may crash
  104.     3.  Edit NEWMSG.BAT  <- if it's wrong the program may crash
  105.     4.  You must run MKAF before running anything else.
  106.     5.  Run MKHIDX.
  107.     6.  Add appropriate menu entry to run NEWMSG.BAT using Dorinfo1.Def.
  108.     7.  Edit your BINKLEY/MAILER/LOGOFF.BAT as necessary (details above).
  109.     8.  Run NEWMSG (dorinfo1.def must be present in the same directory as
  110.         NEWMSG or the program won't run).
  111.  
  112.                                 More Detailed SETUP
  113.                                 ~~~~~~~~~~~~~~~~~~~
  114.     Place all the system files in your TAG (Main BBS) directory.
  115.     System files are MKAF.EXE, MKHIDX.EXE, NEWMSG.EXE and TNEWMSG.CFG.
  116.  
  117.     Do this is the following order:
  118.  
  119.     1. Make/Edit a NEWMSG.CFG file to suit your system.
  120.  
  121.     Example NEWMSG.CFG files
  122.  
  123.       Note: There must ALWAYS be at least 4 lines in NEWMSG.CFG.
  124.  
  125.       Structure of NEWMSG.CFG for 2 Hudson style message areas:
  126.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  127.       Line 1 : c:\tagm2\                  <-- your Main BBS Directory
  128.       Line 2 : c:\tagmulti\               <-- path to USER.LST
  129.       Line 3 : c:\tagm2\gfiles\           <-- path to MBOARDS.DAT
  130.       Line 4 : 2                          <-- # of Hudson style MSG bases
  131.       Line 5 : C:\TAGM1\QBBS\             <-- Hudson msg base 1 directory
  132.       Line 6 : C:\RA\                     <-- Hudson msg base 2 directory
  133.  
  134.       Structure of NEWMSG.CFG for 1 Hudson style message area:
  135.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  136.       Line 1 : c:\tagm2\                  <-- your Main BBS Directory
  137.       Line 2 : c:\tagmulti\               <-- path to USER.LST
  138.       Line 3 : c:\tagm2\gfiles\           <-- path to MBOARDS.DAT
  139.       Line 4 : 1                          <-- # of Hudson style MSG bases
  140.       Line 5 : C:\TAGM1\QBBS\             <-- Hudson msg base 1 directory
  141.  
  142.       NOTE: If you mess up this setup the door will crash guaranteed! :)
  143.  
  144.       If you have more than 1 Hudson style message area then Line 4 must be
  145.       the number of Hudson style areas you have.  Lines following Line 4
  146.       must be the path(s) to the Hudson areas.
  147.  
  148.     2. Edit your NEWMSG.BAT to suit your system
  149.  
  150.     Sample NEWMSG.BAT (files in BBS directory)
  151.     ~~~~~~~~~~~~~~~~~
  152.     @echo off
  153.     NEWMSG
  154.     exit
  155.     ~~~~~~~~~~~~~~~~~
  156.  
  157.     NOTE: NEWMSG requires DORINFO1.DEF in the current directory.
  158.  
  159.     T.A.G. Menu setup:
  160.  
  161.     Pkey : ":"
  162.     PData: "NEWMSG"
  163.  
  164.                              Hudson Requirement
  165.                              ~~~~~~~~~~~~~~~~~~
  166.     You must run MKHIDX.EXE everytime someone logs off of your system.
  167.     It must reside and be run from the same directory as Newmsg.Exe.  It
  168.     makes a file called NEWMSG.IDX in all your message area directories.
  169.     It speeds things up greatly for getting the TAG board number in Hudson
  170.     areas.
  171.  
  172.                            DESQView COMPATIBILITY
  173.                            ~~~~~~~~~~~~~~~~~~~~~~
  174.     The program will check to see if DV is loaded and compensate for it
  175.     if DV is found.
  176.  
  177.                                 Other stuff
  178.                                 ~~~~~~~~~~~
  179.     That's about it.  If you run into any problems with it just let me know
  180.     and I'll fix it.
  181.  
  182.                                 Registration
  183.                                 ~~~~~~~~~~~~
  184.     If you use this program on your BBS you are required to register it with
  185.     the author.  Hundreds of hours went into developing, writing and adding
  186.     features that TAG sysops asked for.
  187.  
  188.     To register send $10 to
  189.  
  190.     Mark McKay
  191.     PO Box 68063
  192.     Virginia Beach, VA 23455
  193.  
  194.     Include with the $10 a the following information for your "key"
  195.     Please state that the registration is for TNewmsg.
  196.  
  197.     Sysop Name (case sensitive)
  198.  
  199.                   First Name    -----------------------------------
  200.                  Second Name    -----------------------------------
  201.  
  202.     BBS Name (case sensitive)
  203.                                 -----------------------------------
  204.  
  205.     When I receive your money I will promptly send you your key (normally the
  206.     same day) by one of the following methods (at my discretion).
  207.  
  208.     1. By direct crash netmail if you have a Fidonet node number.
  209.     2. I'll upload it to your BBS (if you give me the number).
  210.     3. By US Mail (if you give me an address to send it to.).
  211.  
  212.     Finally I apologize to all the TAG sysops out there for the delays in
  213.     TNEWMSGB.  At the time I was severely perturbed at TAG sysops in general.
  214.     I got over it though so here's a "usable" copy of NEWMSG for you to
  215.     evaluate.  If you find that it's a good utility, please do the right thing
  216.     and register it.
  217.  
  218.     Mark McKay
  219.     FidoNet 1:271/22
  220.     The PlayWorld BBS
  221.     1-804-499-5150  HST 14.4K
  222.  
  223.     ----------------------------------------
  224.     Registered TNewmsg Sysops As of 06/09/92
  225.     ----------------------------------------
  226.     Hawley Warren
  227.     Tom LeClerc
  228.     Bill Gatewood
  229.     Rich Landers
  230.     Dennis Matney
  231.     ----------------------------------------
  232.  
  233.     History of Newmsg.
  234.     1.00 - Initial wide beta release
  235.     1.01 - Fixed stupid bug in checking for backslashes on paths
  236.            Sped up MKHIDX.
  237.